50325-0621 (Seq. No. 4615) 


Patent 


United States Patent Application 

FOR 


Techniques for binding An Application With A Data exchange Format Based 

On tags In comments 


Inventors: 

Yehoshua Hershberg 
YishayMor 


PREPARED BY: 


Hickman, Palermo, Truong & Becker 
1600 Willow Street 
San Jose, Ca 95125 

(408) 414-1080 


EXPRESS MAIL FILING INFORMATION 

"Express Mail" mailing label number: EL734971026US 


Date of Deposit: November 26, 2001 


TECHNIQUES FOR BINDING AN APPLICATION WITH A DATA EXCHANGE 
FORMAT BASED ON TAGS IN COMMENTS 


CROSS-REFERENCE TO RELATED APPLICATIONS 

[0001] This application is related to prior U.S. application Ser. No. 09/978,966, filed on 
October 15, 2001, by inventors Yishay Mor and Gadi Berman, entitled "Techniques For 
Generating Software Application Build Scripts Based On Tags In Comments." 

FIELD OF INVENTION 

[0002] The present invention generally relates to exchanging data with an application. 
The invention relates more specifically to techniques for binding a data exchange format, 
such as XML, to an application based on tags in comments of source code for the application. 

BACKGROUND OF THE INVENTION 

[0003] Data exchange between independently developed applications running on 
different families of processors is often accomplished with a published (open) markup 
language. For example, the HyperText Markup Language (HTML) is used for exchanging 
data over the Internet between resources of the world wide web. HTML is one example of a 
markup language derived from Standard Generalized Markup Language (SGML). Another 
language derived from SGML that is more powerful and flexible than HTML has been 
defined and has gained popularity for providing information across networks. The new 
standard, developed and promoted by the World Wide Web Consortium (W3C), is called the 
Extensible Markup Language (XML). XML provides a common syntax for expressing 
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structure in data. Structured data refers to data that is tagged for its content, meaning, or use. 
XML provides an expansion of the tagging that is done in HTML. Whereas HTML focuses 
on format or presentation, XML focuses on content or use. 

[0004] The elements of an XML document are defined in an XML grammar that is 
defined in a document type definition (DTD) document or XML schema. An XML grammar 
is a set of syntax rules for elements in SMGL and XML documents. The grammar defines 
what elements can be used in a document, what order they should appear in, if any, which 
elements can appear inside other elements, which elements have attributes, and what those 
attributes are. A grammar can be part of an XML document, or can be a separate document 
or series of documents in one or more files. XML allows documents to contain elements 
from several distinct DTE) documents or schemas by the use of namespaces. 
[0005] Data exchange also occurs between independently developed applications running 
on different families of processors and a database server. Such data exchange is often 
accomplished with a published (open) database query language. For example, the Structured 
Query Language (SQL) is used for exchanging data with database servers of several database 
systems. As used herein, a data exchange format includes either a markup language or a 
database query language or both. 

[0006] Software applications execute on computing devices to perform a variety of 
functions related to processing and presenting information to users. Software applications 
often read, process and write information in the form of data objects. An object is a data 
structure that includes values for one or more attributes and may have one or more methods 
that provide behavior associated with those attributes. For example, when invoked, one 
method of a particular data object returns a current value of one of its attributes. A data 
structure that lists the attributes and methods of one or more similar objects is called the type 
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or class of the objects. Each individual object, with specific values for the attributes, is an 
instance of the type or class. One object may have another object as an attribute. A 
programming language variable is a simple class of data objects, which support only one 
instance at a time; at different times the variable can contain different values, each 
considered a different instance of that variable class. 

[0007] An application is typically developed as one or more source code modules, each 
written in a high-level programming language designed to facilitate human understanding of 
the steps involved in each module. Example high-level programming languages include 
FORTRAN, Visual Basic, C, C++, and Java®. Statements in such languages are combined 
to write each module. One or more source code modules are stored together in a source code 
file. The statements are converted to instructions for a processor on a computing device, 
which instructions are sometimes called machine instructions, by a particular process, such as 
a compiler. A compiler generates machine instructions based on several statements or an 
entire module. The machine instructions are peculiar to particular families of processors. 
[0008] Currently, when a developer writes source code for an application, data structures 
such as data objects are defined and manipulated internally. If some data is to be imported to 
one or more of these data structures from other independently-developed applications, or 
exported from one or more of these data structures to other independently-developed 
applications, or both, then it is common to convert data between the data structures used 
internally and an exchange format, such as a markup language like XML, used for 
exchanging data. Converting data from an internal data structure to an exchange format is 
called marshalling the data to the exchange format. Converting data from an exchange 
format to the internal structure is called de-marshalling the data from the exchange format. 


50325-0621 (Seq. No. 4615) 


-3- 


[0009] In past approaches, a developer is required to write and maintain data models 
redundantly. The developer implements the data model in program source code using data 
structures defined by the programming language, such as Java classes, and also separately 
implements the data model in some exchange format, such as an XML DTD document or 
schema, hi addition, the developer is forced to write extra source code modules to marshal 
and de-marshal data with the exchange format. 

[00010] The popularity of Java as a platform-independent programming language and the 
proliferation of XML for data representation has created a strong need for a convenient way 
of developing Java data objects that can easily be marshaled to XML and de-marshaled from 
XML. The marshaling and de-marshaling of Java data objects to XML is termed "XML/Java 
Data Binding" in this document. 

[0010] One conventional approach to XML/Java Data Binding examines an XML DTD 
document and generates Java code defining object classes based on the XML DTD, and also 
generates methods for the classes that marshal and de-marshal data between an XML 
document and data objects of the classes. Example products that employ this approach 
include Java Architecture for XML Binding (JAXB) from Sun Microsystems, Inc., XML 
Studio from Breeze Factor LLC, and "Zeus" from Enhydra.org of Lutris Technologies, Inc. 
The product from Sun Microsystems is based not only on the XML DTD but also a second 
XML document that describes an association between XML elements/attributes and Java 
classes/attributes. 

[0011] Another conventional approach to XML/Java Data Binding examines an XML 
grammar, as defined in a schema or DTD, and generates Java code defining object classes 
based on the grammar and also generates methods for the classes that marshal and de- 
marshal data between an XML document and data objects of the classes. An XML Schema 
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document is an XML document with a limited number of elements for defining the elements 
of other XML documents. An XML Schema is a more easily understood way to define the 
components of an XML document than is a DTD document. 
[0012] Another conventional approach to XML/Java Data Binding examines, at 
execution time, Java classes that support introspection, automatically develops an XML 
Schema consistent with the data model of the Java classes, and automatically marshals and 
de-marshals data between objects of those classes and XML documents using the developed 
XML Schema. Java classes that support introspection, such as JavaBeans, include methods 
that provide a list of attributes and attribute types for the class. Example products that employ 
this approach include "Castor" from Exolab.org of Jutalio, Inc. Castor provides for schema- 
less binding. A developer merely invokes the tool at runtime on a set of Java objects, without 
providing any mapping to XML. The marshaling and unmarshaling is done automatically, 
using a generic mapping.. A similar approach is taken by the "Long Term JavaBeans™ 
Persistence" framework described in the document "beans.html" in the online Web folder 
java.sun.com/xml/. 

[0013] While suitable for many purposes, the conventional approaches suffer some 
disadvantages. The approaches that base Java code on XML DTD force a developer to 
accept data objects defined by the data exchange format instead of the other way around. For 
the developer to determine the object classes, the developer must first compose the XML 
DTD, then run the tool to generate the Java classes, and then return to complete the 
programming in Java. This sequence interrupts program development and is inconvenient. 
Further, the class definitions and class hierarchy are defined prior to invocation and 
regardless of the binding mechanism. Binding tools that generate classes do not take the 
existing class structure into account. Tools such as Castor and JavaBean long-term 
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persistence that generate the XML based on the class structure leave too little control on the 
XML schema or DTD in the hands of the developer. There is a need for a tool to bind a given 
schema to a given class structure. It would be preferable for the developer to develop the 
application in the programming language and deduce the exchange format from the classes 
defined for the application. Also, the approach is specific to Java and XML and does not 
work if the developer is using a different programming language or exchange format. 
[0014] The approach that bases an XML DTD on the Java code is rule based and 
automatically organizes and names the XML elements and attributes without control of the 
developer. The rules may not be consistent with the developer's intentions for data 
exchange. For example, this approach does not allow a developer to distinguish whether one 
data object should be an XML attribute or an XML sub-element of another XML element. 
Also the developer may wish to associate two data items by giving them related names, like 
"salt" and "pepper;" the conventional approach automatically names the data items and 
denies the developer the opportunity to assign more meaningful names. Also the developer 
may wish to restrict the number of sub-elements contained in an XML element. The 
conventional approach does not permit the developer to impose such restrictions between 
XML elements. In addition, the developer may wish to exchange data in only a subset of the 
classes defined in the source code; however, the conventional tool automatically generates 
XML DTD statements for all the classes. 

[0015] Furthermore, this approach executes more slowly. The XML schema is deduced 
at runtime, which takes extra processing time. Also, the extra logic to determine how to 
marshal and de-marshal, given the deduced XML schema, also takes additional time to 
execute. The slower execution of this approach can become a hindrance to performance, 
especially as the source code becomes larger and more complex. 
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[0016] Based on the foregoing, there is a clear need for techniques that automatically 
employ an open exchange format that is configured for data structures internal to the source 
code and that is responsive to developer choices for options in employing the open exchange 
format. 

[0017] Furthermore there is a need for techniques that additionally can automatically 
generate instructions to marshal and de-marshal data between the open exchange format 
employed and the internal data structures. 

[0018] In particular, there is a need for techniques that automatically produce an XML 
DTD document that is based on Java data objects defined by a developer and that is 
responsive to developer choices for options in the XML DTD. 
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SUMMARY OF THE INVENTION 

[0019] The foregoing needs, and other needs and objects that will become apparent from 
the following description, are achieved in the present invention, which comprises, in one 
aspect, a method for binding a data exchange format with a computer program application 
having source code in a particular language. Comment data is received from a particular file 
that includes the source code. A source code processor of the particular language ignores 
comment data. The comment data includes first data indicating a parameter of the data 
exchange format. Second data from the particular file is also received. The second data is 
associated with the comment data and includes a statement that defines a class of data objects 
in the particular language. Based on the first data and the second data, third data for 
configuring the data exchange format is generated. 

[0020] According to an embodiment of this aspect, the data exchange format is an 
extensible markup language (XML). 

[0021] According to an embodiment of this aspect, the particular language is the Java 
language; and the first data includes a tag for an automated Java documentation system called 
JavaDoc. 

[0022] According to another aspect of the invention, a method for binding a data 
exchange format with an application having source code in a particular language includes 
inserting first data into the source code within comment data. The first data includes a tag 
and a parameter of a data exchange format. The method includes causing a processor to 
produce second data for configuring the data exchange format based at least in part on the 
first data. 

[0023] According to an embodiment of this aspect, the particular language is the Java 
language and the tag is a user-defined tag of an automated Java documentation system called 
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JavaDoc. The step of causing a processor to produce the second data involves providing a 
routine called a doclet to produce the second data. JavaDoc automatically invokes the doclet 
in response to the tag. Multiple nested Java classes are also handled. 
[0024] In other aspects, the invention encompasses an apparatus, a computer apparatus 
and a computer readable medium, including a carrier wave, configured to carry out the 
foregoing steps. 

[0025] These techniques allow a developer to automatically produce an XML DTD 
document that is based on Java data objects defined by the developer and that is responsive to 
the developer's choices for options in the XML DTD. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

[0026] The present invention is illustrated by way of example, and not by way of 
limitation, in the figures of the accompanying drawings and in which like reference numerals 
refer to similar elements and in which: 

[0027] FIG. 1 A is a block diagram that illustrates files and processes on a development 
platform that perform XMIVJava Data Binding, according to an embodiment; 
[0028] FIG. IB is a block diagram that illustrates files and processes on a development 
platform that perform XMIVJava Data Binding, according to another embodiment; 
[0029] FIG. 1C is a block diagram that illustrates XML/Java Data Binding on a 
deployment platform, according to an embodiment; 

[0030] FIG. 2 is a flow chart that illustrates at a high level a method for performing 
XML/Java Data Binding, according to an embodiment; 

[0031] FIG. 3 is a flow chart that illustrates a method for a Java documentation system 
doclet process that performs XMUJava Data Binding, according to an embodiment; and 
[0032] FIG. 4 is a block diagram that illustrates a computer system upon which an 
embodiment may be implemented. 
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DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 
[0033] A method and apparatus for binding a computer program application with a 
markup language for data exchange is described. In the following description, for the 
purposes of explanation, numerous specific details are set forth in order to provide a 
thorough understanding of the present invention. It will be apparent, however, to one skilled 
in the art that the present invention may be practiced without these specific details. In other 
instances, well-known structures and devices are shown in block diagram form in order to 
avoid unnecessarily obscuring the present invention. 

- OPERATIONAL CONTEXT 
[0034] To illustrate an example of binding a computer program application 
("application") with a markup language, assume that a Java source code module for the 
application includes a class to be bound with XML. The class describes employees, each 
employee an object of the class. Also assume that a JavaDoc tool, described below, is 
employed to perform the binding. 

[0035] Although Java and XML are described herein for purposes of illustrating an 
example embodiment, the invention is not limited to this embodiment. In other 
embodiments, other classes are bound to XML. In yet other embodiments, data structures in 
source code in other languages may be bound to other open data exchange formats. For 
example, data structures can be bound to columns and tables in a database system for use in a 
query language data exchange. In some embodiments the JavaDoc tool is not employed. 
Instead of the JavaDoc tool, a parser is developed to search through the source code and find 
the binding information. 
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- - SOURCE CODE 

[0036] Table 1 lists example Java source code statements from an example application. 
Assume the application determines whether to offer an employee an early retirement 
package; and that source code for the application is stored in a file called retire. java. Java 
code in an Employee.java file defines an Employee class for data objects that describe 


individual employees. 

Table 1. Statements in an Example Java Source Code File 


Line Number 

Java Statement 

1 

2 

/** 

3 

* This class represents employees of the company running the application 

4 

*/ 

5 

public class Employee { 

6 

/** 

7 

* empname is the last name of the employee 

8 

*/ 

9 

public String empname 

10 

/** 

11 

* empid is the identification number of the employee 

12 

*/ 

13 

public int empid 

14 


15 

} 


[0037] The ellipses in lines 1 and 14 indicate other Java statements that are not relevant 
to the illustrated embodiment. A comment statement contains data that is ignored by the 
compilers for the programming language. For example, in Java, as in C and C++, a comment 
is delimited by the symbols "/*" and "*/", or by the symbol "//" and a newline character, and 
a documentation comment statement is delimited by the symbols 7**"and "*/". Java 
compilers and interpreters do not process such comments or documentation comments. 
[0038] The comment statement in lines 2 though 4 indicates to a reader of the source 
code that a neighboring Java statement, which defines a class, is defining a class for 
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employees of the company that is using the application. The Java statements from line 5 
though the closing brackets on line 15 define the class. The class is named "Employee" and 
is public, that is, available to be used in other Java classes. The class includes attributes 
"empname" and "empid" defined in lines 9 and 13, respectively. Empname is a series of 
characters, as indicated by the type "String" in line 9, and is public. Empid is an integer 
number, as indicated by the type "int" in line 13, and is also public. The comment statement 
in lines 6 through 8 indicates that the neighboring attribute, empname, includes the last name 
of the employee when an object of the class is instantiated. The comment statement in lines 
10 through 12 tells a reader of the source code that the neighboring attribute, empid, includes 
an identification number of the employee when an object of the class is instantiated. 

- - JAVADOC TOOL 
[0039] A JavaDoc process is a software tool that uses information in comments 
statements in source code to generate application programming interface (API) 
documentation in HTML format. Descriptions of the JavaDoc tool at the time of this writing 
can be viewed from file indexMtml on the javadoc subdirectory of the j2ee directory on the 
worldwide web (www) at domain7ava.5Mn.org. 

[0040] The JavaDoc tool allows users to define Java classes, called doclets, with methods 
that are invoked when a tag registered with the JavaDoc tool is encountered in comments in 
the source code. JavaDoc includes doclets with methods that are invoked for initially 
registered tags. The JavaDoc tool identifies tags in comments by the symbol "©"followed 
by a keyword. Jn one embodiment, the keywords in tags initially registered with the JavaDoc 
tool include "Company," "author," "version," and "Copyright," among others. "Company" 
and "Copyright" are non-standard tags. The JavaDoc tool allows a user to register additional 
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tags with other keywords and supply doclets to be invoked when the additional tags are 
encountered in comment statements. 

- STRUCTURAL OVERVIEW 
[0041] FIG. 1 A is a block diagram that illustrates files and processes on a source code 
development platform 102 according to an embodiment. The structural elements of FIG. 1 A 
are introduced in this section. A description of how the structures are used is given in more 
detail below with reference to FIG. 2 and FIG. 3. 

[0042] The source code resides in source code file 1 04. For example, the Java statements 
listed in Table 1 are included in the source code file 104. The developer of the source code in 
file 104 knows information about the data structures that are relevant to binding with XML. 
For example, the developer knows that data in the class Employee will be exchanged with 
one or more other applications running on a network, but that data in other classes are 
generated and used internally and are not exchanged with other applications. For example, 
data in a class created for a projected retirement date and earnings is not going to be 
exchanged with other applications. 

[0043] According to the illustrated embodiment, the developer generates a modified Java 
source code file 1 12 based on the Java source code file 104 by inserting into a comment 
statement 114, for each class of data objects to be exchanged with other applications, data 
exchange configuration information in the form of XML configuration information 116 that 
indicates a relationship between data object classes and XML elements. 
[0044] The XML configuration information 1 16 is inserted into the comment statement 
associated with a definition statement for a class of data objects, including the attributes of 
the class. In the illustrated embodiment, the XML configuration information 116 includes a 
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tag 1 18 that identifies the XML configuration information 116 within the comment 
statement. In the illustrated embodiment, the tag 1 1 8 is a tag defined by a user for the 
JavaDoc process 120. In other embodiments, any tag may be used. 
[0045] For example, Table 2 shows statements in a modified Java source code file called 
Employ ee.java. The comment statement, an example of comment statement 114, originally 
in lines 2 through 4 is modified by inserting line 3.5 that includes XML configuration 
information, an example of XML configuration information 1 16. The XML configuration 
information 1 16 includes the user-defined JavaDoc tag "@xml-root-element" that is an 
example of tag 1 1 8, and the property "dtdFile." The property is set to a value 
"employee.dtd" given between the quotation marks in line 3.5. 


Table 2. Statements in an Example Modified Java Source Code File 


Line Number 

Java Statement 

1 
2 
3 
3.5 
4 
5 
6 
7 
7.5 
8 
9 
10 
11 
11.5 
12 
13 
14 
15 

/** 

* This class represents employees of the company running the application 

* @xml-root-element "Employee" dtdFile = "employee.dtd" 
*/ 

public class Employee { 

/** 

* empname is the last name of the employee 

* @xml-element "LastName" 
*/ 

public String empname 
/** 

* empid is the identification number of the employee 

* @xml-attribute "empid" required element = "Employee" 
*/ 

public int empid 

) 


[0046] The tag, @xml-root-element, indicates that the neighboring Java statement that 
defines a class is to serve as a root element for the XML documents that are used to exchange 
data with the application. A root element serves as the top of a hierarchy of elements that 
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appear in an XML document. The property indicates that the root element is to be placed in 
its own grammar file, which may contain other elements, and the root element is identified as 
such in the grammar file; and the value for the property gives a name for the DTD file. In 
this example, the neighboring Java statement is the statement in line 5 defining the class 
Employee. Thus the XML configuration information 1 16 in comment 1 14 in the example of 
lines 3 through 4 indicates that the public class Employee is to be mapped to the root element 
"Employee" in the XML grammar defined in employee.dtd. 

[0047] The comment statement originally in lines 6 through 8 is modified to insert line 
7.5 of XML configuration information. The XML configuration information includes the tag 
"@xml-element" and the value "LastName" given between the quotation marks in line 7.5. 
This tag indicates that the neighboring Java statement that defines the attribute of class 
Employee is to serve as an element for the XML documents that are used to exchange data 
with the application. The value gives a name for the XML element that is more descriptive 
than the variable name, lii this example, the neighboring Java statement is the statement in 
line 9 defining the class attribute, empname, as a public variable containing a string of 
characters. Thus the configuration information 1 16 in comment 1 14 in the example of lines 6 
through 8 indicates that the public variable empname is to be mapped to an XML element 
called LastName, which is a sub-element of the root element Employee. This information is 
to be included in the DTD file named employee.dtd. 

[0048] The comment statement originally in lines 10 through 1 3 is modified to insert line 
1 1.5 of XML configuration information. The XML configuration information includes the 
tag "@xml-attribute" and the properties "required" and "element." The designation 
"element" refers to the element that this attribute is attached to; "required" indicates that this 
attribute must be present in any XML element of this type. The element property is set to a 
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value "Employee" given between the quotation marks in line 7.5. This tag indicates that the 
neighboring Java statement that defines a class of data objects (in this case an attribute of the 
class) is to serve as an attribute of the element Employee for the XML documents that are 
used to exchange data with the application. The attribute's default property is required, 
which means that a value must be provided for the attribute whenever the element Employee 
is included in an XML document. 

[0049] The property element is optional in the illustrated embodiment, but if the element 
property is not specified, then, in this embodiment, all data-members are assumed to be 
attributes of the root element. Since no value is given for the name of the attribute, the 
attribute is given the same name as the class or variable in the neighboring Java statement. In 
this example, the neighboring Java statement is the statement in line 13 defining the variable, 
empid, as a public variable containing an integer. Thus the XML configuration information 
1 16 in comment 1 14 in the example of lines 10 through 12 indicates that the public variable 
empid is to be used as an XML attribute, by the same name, of the XML element Employee. 
This information is to be included in the DTD file named employee.dtd. 
[0050] According to the illustrated embodiment, a user-defined doclet 1 24 is included in 
the JavaDoc process 120. The user-defined doclet 124 includes methods to be invoked for 
one or more JavaDoc tags, including one or more user-defined tags, hi other embodiments, 
additional doclets are included in JavaDoc process 120. One or more methods of the user- 
defined doclet 124 produces statements 130 for an XML DTD or Schema document based on 
the XML configuration data 1 16 in the comment statement 1 14 for a data object in the 
modified source code file 1 12 and on the neighboring Java class definition statement. For 
example, the doclet 124 generates the XML DTD statements in Table 3. 
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Table 3. Statements in an Example XML DTD File 


Line Number 

DTD Statement 

1 
2 
3 

< [ELEMENT Employee (LastName)> 

<!ATTLIST Employee empid CD ATA #REQUIRED> 

<!ELEMENT LastName CDATA> 


[0051] The XML DTD statement in line 1 of Table 3 indicates that the root element, the 
first element in the DTD file, is called Employee and that the Employee element must 
include the sub-element LastName only once. The statement in line 2 indicates that the 
attributes of the element Employee include empid. CD ATA indicates that the contents of the 
attribute are any character data. #REQUTRED indicates that the attribute must always be 
included when the Employee element is used. The statement in line 3 indicates that the 
element LastName does not include any other elements and that the LastName element may 
be filled by character data. 

[0052] An application developer is able to control the formation of the DTD file from the 
Java class. The conventional system might make both empname and empid the same type of 
XML components since both are attributes of the class that are not themselves made up of 
sub-classes. Since both are single-valued, simple variables, the conventional system is likely 
to make both attributes of the element Employee. The resulting DTD is contrary to the desire 
of the developer to make the empname variable a separate XML element. Furthermore, the 
conventional system would not allow the elements to be re-named, as empname is here 
renamed LastName to be more descriptive. 

[0053] Each XML element becomes an opening tag and a closing tag in an XML 
document. An opening tag includes angled brackets, <>, around the element name; and a 
closing tag includes angle brackets around the element name with a slash preceding the 
name. Thus the XML element's name, LastName, is used as an opening tag <LastName> 
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and a closing tag </LastName>. Between the opening tag and the closing tag, the element 
contains the information type indicated; for example, the element contains the character data 
indicating the last name of the employee inserted between the tags <LastName> and 
</LastName>. Attributes, if any, are included in the opening tag. An example XML 
document with statements using the elements defined in the DTD file are given in Table 4 for 
two employees, John Smith and Jane Doe having employee identification numbers of 
73645112 and 1, respectively. 


Table 4. Example XML Document Using Elements Defined in DTD File 


Line Number 

XML Statement 

1 

<!DOCTYPE Employee SYSTEM "employee.dtd"> 

2 

< Employee empid = "73645 112"> 

3 

<LastName> Smith </LastName> 

4 

</Employee> 

5 

< Employee empid = "1"> 

6 

<LastName> Doe </LastName> 

7 

</Employee> 


[0054] The statement in line 1 is the document type declaration that tells an XML 
processor what DTD file, if any, defines the elements and attributes used by the current XML 
document. <!DOCTYPE . . . > indicates the statement is the document type declaration 
statement. The root element of the document type, Employee, is the first item in the 
statement. SYSTEM indicates the next value, "employee.dtd," is where the XML 
configuration information resides. 

[0055] The statement in line 2 is an opening tag for the Employee element. It includes 
the Employee element's required attribute, empid. The attribute empid has a value of 
736451 12. The required single instance of the LastName element appears in line 3 as the 
opening and closing tags <LastName> and </LastName>, respectively, and the interspersed 
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data. Between the opening and closing tags is the LastName data, Smith. The statement in 
line 3 is the closing tag for the Employee element. 

[0056] Similarly, the statement in line 5 is an opening tag for another Employee element. 
It includes the Employee element's required attribute, empid. The attribute empid has a 
value of 1. The one instance of the LastName element appears in line 6 as the opening and 
closing tags <LastName> and </LastName>, respectively. Between the opening and closing 
tags is the LastName data, Doe. The statement in line 7 is the closing tag for the Employee 
element. 

[0057] The example XML document in Table 4 is used to exchange data between the 
application having the source code in Table 1 (and Table 2) and other applications. For 
example, the XML document in Table 4 serves as input to the application. 
[0058] Using the JavaDoc tool, JavaDoc tags are automatically detected in the source 
code and the information associated with the tag is automatically passed to the doclet. 
Therefore preparing a doclet that generates the XML DTD, or any exchange format 
configuration file, is a simpler task than programming a separate process to parse through the 
source code and find the configuration information 1 16. In some embodiments, however, a 
separate process, which is not a doclet of the JavaDoc process, does the parsing, finds the 
configuration information 1 16 in the comment statement 1 14, and produces the XML DTD 
statements 130 based on the configuration information 1 16 and the neighboring Java class 
definitions. 

[0059] In some embodiments, the doclet or the separate process also produces Java 
modules for marshaling and de-marshalling data between the Java application module and 
XML documents. For example, in the illustrated embodiment the user-defined doclet 124 
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generates the Java modules 190 that marshal and de-marshal data between the application 
and XML documents. 

[0060] In other embodiments, one of the conventional approaches is used to generate the 
Java modules 190 based on the XML DTD 130. In some of these embodiments, the 
conventional approach used employs not only the DTD file but also a mapping file that maps 
DTD elements/attributes to Java class attributes. In such embodiments the doclet 124, or 
separate process, generates not only the DTD document, but also generates the mapping file. 
FIG. IB is a block diagram that illustrates files and processes on a development platform that 
perform XML/Java Data Binding according to such an embodiment. In the illustrated 
embodiment, the Java source code file 104 and the modified Java source code file 1 12 are the 
same as in the embodiment depicted in FIG. 1 A. However, in the embodiment of FIG. IB, 
the doclet 124 produces both the XML DTD file 130 and the mapping file 170 that maps 
DTD elements/attributes to Java class attributes for use by a conventional process 175. The 
conventional process 175 for XML/Java Data Binding is then executed to produce the Java 
modules 190 for marshaling and de-marshaling data between the application and XML 
documents. 

[0061] Table 5 shows statements in an example Java module for de-marshaling data from 
an XML document, such as the XML document listed in Table 4. 


Table 5. Example Java Statements in De-marshaling Module 


Line Number 

Java Statement 

1 
2 
3 
4 
5 
6 

public class EmployeeXMLHelper{ 

public Employee fromXML(InputStream in){ 

public void toXML(Employee employee, OutputStream out){ 
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[0062] The statement in line 1 indicates that a class named EmployeeXMLHelper will be 
generated to provide marshaling and De-marshaling services. The three dots on lines 3 and 5 
represent Java code that is not relevant to this example. The statement on line 2 defines a 
routine that, given an input source for the retrieval of XML de-marshals this data into an 
Employee object. The statement on line 4 defines a routine that receives an Employee object, 
marshals it to the XML format and writes this XML data to an output destination. 
[0063] FIG. 1 C is a block diagram that illustrates XML/Java Data Binding on a 
deployment platform 140, according to an embodiment. Although the files and processes are 
depicted on a single platform in FIG. 1C, in other embodiments one or more of the files and 
processes may reside on other platforms connected to the platform 140 by a computer 
network. 

[0064] The XML DTD filed 130 is available on the platform 140, as are the modified 
Java source code file 1 12 and the Java modules 190 that marshal and de-marshal data. A 
build tool 154 is a process that collects the modules for an application and generates machine 
instructions and data (executable code) of the application for execution by a computer 
processor. The first application 160 is the executable code that provides the behavior for the 
application. For example, the first application 160 is Java bytecode executed by a Java 
virtual machine for the application that determines whether to offer an employee a retirement 
package. 

[0065] The executable code of the first application 160 is illustrated as a process. When 
the first application 160 is executing on the deployment platform 140, it exchanges data with 
other applications, such as second application 180, using one or more XML documents. 
Execution-time data exchange is indicated in FIG. 1C by arrows 135. For example, second 
application 180 produces XML document 132 based on the XML DTD file 130. The 
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document 132 includes a reference 134 to the DTD file 130. A reference is indicated in FIG. 
1C by arrow 137. The first application accepts the data in XML document 132 by invoking 
the de-marshaling process. For example, the first application 160 de-marshals the XML 
document having the statements listed in Table 4. The "employee.dtd" value for the 
SYSTEM attribute in line 1 is an example of the reference 134 to the XML DTD file 130. 

~ FUNCTIONAL DESCRIPTION 
[0066] FIG. 2 is a flowchart that illustrates one embodiment of a method 200 for binding 
an application with an open exchange format. Although steps are illustrated in FIG. 2 and 
FIG. 3 in a particular order, the steps may be reordered or occur at overlapping times in other 
embodiments. The steps of the flowchart in FIG. 2 are illustrated with reference to the 
example source file in Table 1, described above. 

[0067] hi step 21 0, an application developer inserts tags with configuration information 
for the exchange format, including exchange format parameters and properties, if any, into 
comment statements associated with data object class definitions (including simple variable 
definitions of class attributes). For example, the developer inserts statements in lines 3.5, 
7.5, 11.5 of Table 2. The tag includes a symbol, like "@", which indicates the statement 
should be processed and an exchange format parameter such as "xml-root-element." 
[0068] The parameter may have properties associated with it in the exchange format. For 
example, a root element may be associated with a property for a DTD file name. In such 
cases the property value is given and, in some cases, the property name is also given. For 
example, when the parameter indicates an XML attribute, the attribute's properties include 
the attribute's name, the type of default value, and the name of the element to which the 
attribute belongs. A value for the attribute's name and default type may be included without 
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the property name, but the name of the element to which the attribute belongs is introduced 
by the property name "element" as in statement 1 1.5 to distinguish the element's name from 
the attribute's name. 

[0069] In step 220, a process is provided that produces data for configuring the exchange 
format based on the information in the comment statement and associated class definition 
statement. For example, a doclet is provided for the JavaDoc tool. The doclet produces 
XML DTD based on the exchange format parameters and properties and the associated Java 
class definitions. The doclet performs the steps described in FIG. 3 in more detail below. In 
other embodiments, a process separate from the JavaDoc tool performs the steps described in 
FIG. 3. In some embodiments, the application developer writes the doclet or the separate 
process. In other embodiments, a second party writes the doclet or the separate process and 
the second party provides the doclet, or separate process, to a large number of application 
developers. 

[0070] In step 230, the process is executed to operate on the modified source file. For 
example, JavaDoc is executed to operate on the modified source code file and to invoke the 
doclet associated with each tag encountered in the modified source code. In other 
embodiments the separate process is executed to operate on the modified source code file. 
For example, JavaDoc, or the separate process, is executed to operate on modified source 
code file 1 12, such as the source code in Table 2. 

[0071] In step 240, the data produced is used to configure the exchange format. For 
example, the DTD statements produced by the doclet, or the separate process, are 
incorporated into a DTD file that describes the XML documents used for data exchange with 
the application. For example, the statements shown in Table 3 are inserted in the DTD file. 
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[0072] In step 250, program modules are generated to marshal and de-marshal data with 
the exchange format. For example, Java modules are generated to marshal and de-marshal 
data between XML documents and the application. In some embodiments the Java modules 
are generated by the doclet or the separate process written by the developer or provided by 
the second party. Jn other embodiments the Java modules are generated by one of the 
conventional methods based on the DTD file. 

[0073] In some embodiments, the doclet, or the separate process, generates a mapping 
between Java class definitions and XML elements and attributes. In such embodiments, the 
conventional process uses the DTD file and the mapping to generate the Java modules. For 
example, conventional process 175 uses the DTD file 130 and the mapping 170 to generate 
the Java modules 190. An example mapping between Java class definitions and XML 
elements and attributes is shown in Table 6. 
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Table 6. Example Mapping Between Java Classes and DTD elements and 

attributes ___ 


Line Number 

Java Statement 


<dtd-binding> 


<element name="Employee"> 


<class name="Employee"> 


<bind name="empid"> 


<attribute name="empid7> 

1 

</bind> 

2 

<content> 

3 

<bind name="LastName"> 

4 

<element-ref name="LastName 1 7> 

5 

<attribute name="empname7> 

6 

</bind> 

7 

</content> 

8 

</class> 

9 

</eletnent> 

10 


11 

<element name="LastName ,! > 

12 

<content> 

13 

<pcdata/> 

14 

</content> 

15 

</element> 

16 

</dtd-binding> 

17 


18 


19 


20 


21 



[0074] In this example, Line 2 declares a binding rule for the XML element "Employee". 
Line 3 declares that the element will be bound to a class names "Employee" (defined in 
source file "Employee.java"). Lines 4-6 map the class attribute empid to the XML attribute 
empid. Line 7 marks the beginning of sub-element definitions. Lines 8-1 1 bind the XML sub- 
element LastName to the class attribute empname. Lines 12-14 close elements. Lines 16-20 
define an XML element "LastName" with plain text content. 
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[0075] In step 260, executable code is generated for the application based on the source 
code and the modules for marshaling and de-marshaling data with the exchange format. For 
example executable code 160 is generated based on the source code file 1 12 and the Java 
modules 190 for marshaling and de-marshalling data between the Java classes and XML 
documents using the DTE) file. 

[0076] Subsequently, the executable code is executed and the application exchanges data 
with other applications using the exchange format configured in step 240. For example, the 
application 160 exchanges data using XML documents 132 based on, that is, configured by, 
the DTD file 130. 

[0077] FIG. 3 is a flow chart that illustrates a method 300 for a process, such as a 
JavaDoc doclet, that performs XML/Java Data Binding, according to an embodiment. 
[0078] In step 310, comment data is received that includes a tag with exchange format 
configuration information, such as an XML parameter and its properties. For example, the 
comment data in lines 10 through 12 of Table 2 is received with tag @xml-attribute for the 
XML attribute parameter and with value "required" for the default property and the value 
"Employee" for the property indicating the element to which the attribute belongs. 
[0079] In step 320 the associated statement defining a class of data objects is received. 
For example, Java statements defining a class of data objects are received. As a more 
specific example, the Java statement in line 13 is received, which defines attribute empid of 
class Employee, hi this embodiment, the first Java statement following the comment is 
associated with the comment, hi other embodiments the Java statement preceding the 
comment is associated. In general, one or more statements neighboring the comment are 
associated with the configuration information in the comment. 
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[0080] In step 330, data for configuring the data exchange format is produced. For 
example the XML DTD statements in Table 3 are produced based on the XML parameter 
and properties and the associated Java statement. As a more specific example, line 2 in Table 
3 is produced based on the Java attribute, empid, and the configuration information including 
tag, @xml-attribute, default property, required, and element property, Employee 
[0081] In step 340, a module is generated that marshals a data object of the class to one 
or more data items in the exchange format. For example, a Java module is generated that 
marshals a data object of a Java class into one or more items of the XML configured by the 
DTD. As a more specific example, a Java module is generated that exports an object of class 
Employee having attributes empname and empid into an XML element Employee having 
attribute empid and containing element LastName. Step 340 is optional and may be omitted 
if a conventional process is used to generate the module. In some embodiments, step 340 
comprises producing a file used by the conventional process to generate the module. For 
example, a mapping file 170, such as listed in Table 6, is produced in step 340. 
[0082] In step 350, a module is generated that de-marshals a data object of the class from 
one or more data items in the exchange format. For example, a Java module is generated that 
de-marshals a data object of a Java class from one or more data items of the XML configured 
by the DTD. As a more specific example, a Java module is generated that imports an object 
of class Employee having attributes empname and empid from an XML element Employee 
having attribute empid and containing element LastName. Step 350 is optional and may be 
omitted if a conventional process is used to generate the module. 

[0083] The techniques described above automatically employ an open exchange format 
that is based on data structures internal to the source code and that is responsive to developer 
choices for options in employing the open exchange format. Furthermore these techniques 
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automatically generate instructions to marshal and de-marshal data between the open 
exchange format employed and the internal data structures. In particular, these techniques 
automatically produce an XML DTD document that is based on Java data objects defined by 
a developer and that is responsive to developer choices for options in the XML DTD. 
[0084] The techniques herein also are applicable to multiple nested Java classes. For 
example, there may be two classes as follows: 
/** 

* @xml-root-element dtdFile="department.dtd" 

*/ 

public class Department 

/** 

* @xml-attribute required element="Department" 
*/ 

public String name; 

/** 

* @xml-element 
*/ 

public Employee[] employees; 

} 

/** 

* @xml-element "Employee" 
*/ 

public class Employee{ 
/** 

* @xrnl-element "LastName" 

*/ 

public String empname; 

/** 

* @xml-attribute required element="Employee" 

*/ 

public int empid; 

} 

[0085] Given instances of these classes where a Department was called "Accounting" 
and had two employees, "Flintstone" and "Rubble" the following XML would be produced: 
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<Department name="Accounting"> 
<Employee empid="123"> 

<LastName>Flintstone</LastName> 
</Employee> 
<Employee empid="456"> 

<LastName>Rubble</LastName> 
</Employee> 
</Department> 

- HARDWARE OVERVIEW 
[0086] FIG. 4 is a block diagram that illustrates a computer system 400 upon which an 
embodiment of the invention may be implemented. Computer system 400 includes a bus 402 
or other communication mechanism for communicating information, and a processor 404 
coupled with bus 402 for processing information. Computer system 400 also includes a main 
memory 406, such as a random access memory ("RAM") or other dynamic storage device, 
coupled to bus 402 for storing information and instructions to be executed by processor 404. 
Main memory 406 also may be used for storing temporary variables or other intermediate 
information during execution of instructions to be executed by processor 404. Computer 
system 400 further includes a read only memory ("ROM") 408 or other static storage device 
coupled to bus 402 for storing static information and instructions for processor 404. A 
storage device 410, such as a magnetic disk or optical disk, is provided and coupled to bus 
402 for storing information and instructions. 

[0087] Computer system 400 may be coupled via bus 402 to a display 412, such as a 
cathode ray tube ("CRT"), for displaying information to a computer user. An input device 
414, including alphanumeric and other keys, is coupled to bus 402 for communicating 
information and command selections to processor 404. Another type of user input device is 
cursor control 416, such as a mouse, a trackball, or cursor direction keys for communicating 
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direction information and command selections to processor 404 and for controlling cursor 
movement on display 412. This input device typically has two degrees of freedom in two 
axes, a first axis (e.g., x) and a second axis (e.g., y), that allows the device to specify 
positions in a plane. 

[0088] The invention is related to the use of computer system 400 for forming an 
application. According to one embodiment of the invention, an application is formed from 
source code files by computer system 400 in response to processor 404 executing one or 
more sequences of one or more instructions contained in main memory 406. Such 
instructions may be read into main memory 406 from another computer-readable medium, 
such as storage device 410. Execution of the sequences of instructions contained in main 
memory 406 causes processor 404 to perform the process steps described herein. In 
alternative embodiments, hard-wired circuitry may be used in place of or in combination with 
software instructions to implement the invention. Thus, embodiments of the invention are 
not limited to any specific combination of hardware circuitry and software. 
[0089] The term "computer-readable medium" as used herein refers to any medium that 
participates in providing instructions to processor 404 for execution. Such a medium may 
take many forms, including but not limited to, non-volatile media, volatile media, and 
transmission media. Non-volatile media includes, for example, optical or magnetic disks, 
such as storage device 41 0. Volatile media includes dynamic memory, such as main memory 
406. Transmission media includes coaxial cables, copper wire and fiber optics, including the 
wires that comprise bus 402. Transmission media can also take the form of acoustic or light 
waves, such as those generated during radio wave and infrared data communications. 
[0090] Common forms of computer-readable media include, for example, a floppy disk, a 
flexible disk, hard disk, magnetic tape, or any other magnetic medium, a CD-ROM, any other 
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optical medium, punchcairds, papertape, any other physical medium with patterns of holes, a 
RAM, a PROM, and EPROM, a FLASH-EPROM, any other memory chip or cartridge, a 
carrier wave as described hereinafter, or any other medium from which a computer can read. 
[0091] Various forms of computer readable media may be involved in carrying one or 
more sequences of one or more instructions to processor 404 for execution. For example, the 
instructions may initially be carried on a magnetic disk of a remote computer. The remote 
computer can load the instructions into its dynamic memory and send the instructions over a 
telephone line using a modem. A modem local to computer system 400 can receive the data 
on the telephone line and use an infrared transmitter to convert the data to an infrared signal. 
An infrared detector can receive the data carried in the infrared signal and appropriate 
circuitry can place the data on bus 402. Bus 402 carries the data to main memory 406, from 
which processor 404 retrieves and executes the instructions. The instructions received by 
main memory 406 may optionally be stored on storage device 410 either before or after 
execution by processor 404. 

[0092] Computer system 400 also includes a communication interface 41 8 coupled to bus 
402. Communication interface 418 provides a two-way data communication coupling to a 
network link 420 that is connected to a local network 422. For example, communication 
interface 418 may be an integrated services digital network ("ISDN") card or a modem to 
provide a data communication connection to a corresponding type of telephone line. As 
another example, communication interface 418 may be a local area network ("LAN") card to 
provide a data communication connection to a compatible LAN. Wireless links may also be 
implemented. In any such implementation, communication interface 418 sends and receives 
electrical, electromagnetic or optical signals that carry digital data streams representing 
various types of information. 
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[0093] Network link 420 typically provides data communication through one or more 
networks to other data devices. For example, network link 420 may provide a connection 
through local network 422 to a host computer 424 or to data equipment operated by an 
Internet Service Provider ("ISP") 426. ISP 426 in turn provides data communication services 
through the worldwide packet data communication network now commonly referred to as the 
"Internet" 428. Local network 422 and Internet 428 both use electrical, electromagnetic or 
optical signals that carry digital data streams. The signals through the various networks and 
the signals on network link 420 and through communication interface 418, which carry the 
digital data to and from computer system 400, are exemplary forms of carrier waves 
transporting the information. 

[0094] Computer system 400 can send messages and receive data, including program 
code, through the network(s), network link 420 and communication interface 418. In the 
Internet example, a server 430 might transmit a requested code for an application program 
through Internet 428, ISP 426, local network 422 and communication interface 418. In 
accordance with the invention, one such downloaded application provides for a developer- 
defined doclet as described herein. 

[0095] The received code may be executed by processor 404 as it is received, and/ or 
stored in storage device 410, or other non-volatile storage for later execution. In this manner, 
computer system 400 may obtain application code in the form of a carrier wave. 

- EXTENSIONS AND ALTERNATIVES 
[0096] In the foregoing specification, the invention has been described with reference to 
specific embodiments thereof. It will, however, be evident that various modifications and 
changes may be made thereto without departing from the broader spirit and scope of the 
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invention. The specification and drawings are, accordingly, to be regarded in an illustrative 
rather than a restrictive sense. 
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